The Dreamweaver JavaScript API > File manipulation functions > dreamweaver.browseForFileURL() |
![]() ![]() ![]() |
dreamweaver.browseForFileURL()
Availability
Dreamweaver 1.0, enhanced in 2.0, 3.0 and 4.0
Description
Opens the specified type of dialog box with the specified label in the title bar.
Arguments
openSelectOrSave
, {titleBarLabel}
, {bShowPreviewPane}
, {bSupressSiteRootWarnings}
, {arrayOfExtensions}
![]() |
openSelectOrSave indicates the type of dialog box: open , select , or save . |
![]() |
titleBarLabel , added in Dreamweaver 2, is the label that should appear in the title bar of the dialog box. If this argument is omitted, Dreamweaver uses the default label supplied by the operating system. |
![]() |
bShowPreviewPane , added in Dreamweaver 2, is a Boolean value indicating whether to display the image preview pane in the dialog box. If this argument is true , the dialog box filters for image files; if omitted, it defaults to false . |
![]() |
bSupressSiteRootWarnings , added in Dreamweaver 3, is a Boolean value indicating whether to suppress warnings about the selected file being outside the site root. If this argument is omitted, it defaults to false . |
![]() |
arrayOfExtensions , added in Dreamweaver 4, is an array of strings for specifying the "Files of type" list menu default appearance at the bottom of the dialog box. The proper syntax is menuEntryText|.xxx[;.yyy;.zzz]|CCCC| , where menuEntryText is the name of the file type to appear. The extensions can be specified as .xxx[;.yyy;.zzz] or CCCC , where .xxx specifies the file extension for the file type (optionally, .yyy and .zzz specify multiple file extensions) and CCCC is the four-character file type constant for use on the Macintosh. |
Returns
A string containing the name of the file, expressed as a file:// URL.
Enabler
None.
![]() ![]() ![]() |